home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / dc / dc_fkeys.lzh / dc_fkeys.doc < prev    next >
Text File  |  1991-02-11  |  6KB  |  186 lines
  1. DC F-Keys v1.0
  2.  
  3. Copyright (c) 1991 Double Click Software
  4.  
  5. Program by Michael B. Vederman and Keith Gerdes
  6.  
  7. DC F-KEYS is a FREEWARE program.  A FREEWARE program is one which you may
  8. freely distribute, but you cannot charge for it or alter the program or
  9. contents of the archive in any manner.  Double Click Software retains all
  10. copyright exclusive rights except exclusive distribution.
  11.  
  12. ==============================================================================
  13.  
  14. DC F-Keys allows you to assign a text macro to a function key, or combination
  15. of a function key and one (1) modifier key (SHIFT, CONTROL or ALTERNATE).
  16.  
  17. This could be useful if you enter the same text repeatedly.
  18. For example, you leave an email message and instead of typing your name at the
  19. end, you press F1 and your name is printed for you.
  20.  
  21. You can assign up to 49 function key macros!
  22.  
  23.  
  24. =========================
  25. DC F-KEYS key assignments
  26. =========================
  27. Before you get started, you should decide what text macros you want to assign
  28. to what function keys.
  29.  
  30. DC F-KEYS loads in the text macros from a file named:
  31.  
  32. DC_FKEYS.DAT
  33.  
  34. A sample DC_FKEYS.DAT file looks like:
  35.  
  36. F10
  37. F1=This is F1
  38. R1=This is <RIGHT SHIFT>+<F1>
  39. L5=This is <LEFT SHIFT>+<F5>
  40. C1=This is <CONTROL>+<F1>
  41. A10=This is <ALTERNATE>+<F10>
  42.  
  43.  
  44. *** IMPORTANT NOTE ***
  45. The first line of DC_FKEYS.DAT is the function key which will be used to turn
  46. DC F-KEYS on and off.  You **MUST** have this line.  This key can be any key
  47. as defined directly below.  If you forget this line, then the first macro
  48. assignment function key will be taken as the toggle.
  49.  
  50. Format of the function key definition in DC_FKEYS.DAT is like this:
  51.  
  52. <special character><number>=<Macro>
  53.  
  54. where
  55.    <special character> is:
  56.       'F' for a regular unshifted function key
  57.       'R' for the <RIGHT SHIFT> key pressed at the same time as the 
  58.           function key with number that follows
  59.       'L' for the <LEFT SHIFT> key pressed at the same time as the 
  60.           function key with number that follows
  61.       'C' for the <CONTROL> key pressed at the same time as the 
  62.           function key with number that follows
  63.       'A' for the <ALTERNATE> key pressed at the same time as the 
  64.           function key with number that follows
  65.  
  66.    <number> is a number from 1 to 10
  67.  
  68.    = is the equal sign
  69.    
  70.    <macro> is the text to assign, up to 40 characters
  71.  
  72.  
  73. So, every line must have the function key _immediately_ followed by the
  74. equals sign '=' and the text for the macro.
  75.  
  76. EXAMPLE: C10=This is <CONTROL>+<F10>
  77.          A5=This is <ALTERNATE>+<F5>
  78.  
  79. IMPORTANT NOTE: You may only have 40 characters per macro.
  80.  
  81. ------------------------
  82. Non Printable Characters
  83. ------------------------
  84. You can imbed any character in the macro by using the backslash '\'
  85. character in the macro, followed by the DECIMAL value of the character
  86. you want at that position, and another backslash.  Two backslashes '\\'
  87. in a row would place one (1) backslash in the macro.
  88.  
  89. Each imbedded character counts as one character, so \255\ is really
  90. only one character (if you are keeping count).
  91.  
  92. NOTE: You can only use a number from 0 to 255 (any ASCII character).
  93.  
  94. EXAMPLE: F1=This is a carriage return ->\13\
  95.          F2=This is a backslash ->\\
  96.          F3=This is \13\\10\a split line
  97.  
  98. USEFUL CODES:
  99.  
  100. <CARRIAGE RETURN> = 13
  101. <LINE FEED>       = 10
  102.  
  103.  
  104. ====================
  105. Installing DC F-KEYS
  106. ====================
  107. You can install DC F-KEYS either from the AUTO folder or from the desktop.
  108.  
  109. >To install DC F-KEYS from the AUTO folder, do this:
  110. ----------------------------------------------------
  111.  
  112. 1) Copy DC_FKEYS.PRG and your DC_FKEYS.DAT file into the AUTO folder of
  113.    your bootup disk.
  114.  
  115. 2) Reset your computer.  DC F-KEYS will attempt to load and parse the
  116.    DC_FKEYS.DAT file to define your keys when it runs.
  117.  
  118. When DC F-KEYS installs, you will see an installation message.
  119.  
  120.  
  121. >To install DC F-KEYS from the desktop, do this:
  122. ------------------------------------------------
  123.  
  124. 1) Make sure the DC_FKEYS.DAT file is in the CURRENT directory (which is
  125.    usually the same directory the program is in).
  126.  
  127. 2) Run DC_FKEYS.PRG.  An alert box will appear asking you if you want to
  128.    INSTALL or QUIT DC F-KEYS.  Click on the appropriate button.
  129.  
  130. 3) If you clicked on INSTALL, DC F-KEYS will attempt to load and parse the
  131.    DC_FKEYS.DAT file to define your keys.
  132.  
  133. When DC F-KEYS installs, you will see an installation message.
  134.  
  135.  
  136. ============================
  137. Turning DC F-KEYS On and Off
  138. ============================
  139.  
  140. >To turn DC F-KEYS On or Off, do this:
  141. --------------------------------------
  142.  
  143. 1) Press the function key which is listed at the top of your DC_FKEYS.DAT
  144.    file.  If DC F-KEYS is ON, it will toggle OFF.  If DC F-KEYS is OFF,
  145.    it will toggle ON.
  146.  
  147.  
  148. =============
  149. BUY, BUY, BUY
  150. =============
  151. Have you purchased the DC DESKTOP or DC UTILITIES version 2.0???
  152.  
  153. If not, you owe yourself the pleasure of using our superb programs.
  154.  
  155. "These programs are aSTounding!" - Ken Badertscher, ATARI Corp. talking
  156.                                    about the DC UTILITIES v2.0
  157.  
  158. "The DC DESKTOP is a permanent part of my system!"
  159.                             - Ron Luks, Founder of Compuserve's Sig Atari
  160.  
  161. Call us to order, or ask your local retailer.
  162.  
  163.  
  164. ===========
  165. MORE INPUT!
  166. ===========
  167. If you like this program, great!
  168.  
  169. Be sure to let us know what ideas or comments you have about our software.
  170. We are always anxious to hear what anyone has to say!
  171.  
  172. You can reach us almost everywhere!
  173.  
  174. ========
  175. By Phone
  176. ========
  177. Double Click Software  : (713)977-6520
  178.  
  179. ======
  180. Online
  181. ======
  182. GEnie       :  DOUBLE-CLICK (CATegory 30)
  183. CompuServe  :  75300,577    (GO ATARIVend, area 13)
  184. Usenet      :  uace0@menudo.uh.edu
  185. DC BBS      :  (713)944-0108
  186.